如何参与共建FISCO BCOS?
FISCO BCOS是完全开源的金融级联盟链底层技术平台,由金链盟开源工作组通力打造。开源工作组成员包括微众银行、腾讯、四方精创、深证通、华为、亦笔科技、神州信息、博彦科技和越秀金科等金链盟成员机构。
代码仓库:
https://github.com/FISCO-BCOS/FISCO-BCOS
对平台感兴趣可以star我们。欢迎各路大神一展所长,积极参与建设,为平台添砖加瓦。
用的不爽,自己不想改 →提issues 程序可能有bug →提issues 文档没看懂,不知道怎么改 →提issues 文档有一些笔误,我想顺手改掉 →通过网页修改文档 代码有值得优化的地方 →提交pr 我自己基于FISCO BCOS做了新的特性,想贡献到项目中 →提交pr 我很牛,我开发了一个FISCO BCOS的新项目→联系社区人员
提issues
当你在体验/使用过程中遇到问题,需要联系开发者对问题进行确定,或想要反馈优化建议,可以通过该项目的issues界面发起issues。
issue可跟踪,可复现。你提出的每一个bug ,都会沉淀下来,为那些和你遇到同样 bug 的人提供帮助。具体提交issue方式可参考以下步骤:
前期准备
创建GitHub账号并登录该账号
操作演示
打开FISCO BCOS平台的issues界面,此处可参考链接:
https://github.com/FISCO-BCOS/FISCO-BCOS/issues
在title栏中描述问题类别,如:xxx-bug;在comment中详细描述您遇到的问题。如果您是第一次对该项目提issues,可以查看右侧的contributing guidelines。
提issues Tips
检索问题是否已经存在:高效解决问题,节省大家的时间,我们建议你在发起issues前,先通过官方文档,或issues界面进行搜索,定位是否有和您相同的问题出现过。 清楚描述问题:尽可能地减少沟通成本,我们期望你提交的issue能包含以下内容:使用明确的标题、使用的项目版本、使用的操作系统,出现问题的事实形式,出现问题时程序的log。 解决流程:项目维护人员会根据您提出的问题,给该issues打标签,您可以根据工作人员的回复,在指定路径体验修复该问题后的软件版本。当该issues标记为resolved后,如果您的问题已经解决,可以选择关闭该issues。
通过网页修改文档
查阅FISCO BCOS文档时,如发现有描述错误的地方,你可以通过网页来对文档进行修订。
前期准备
创建GitHub账号并登录该账号
适用场景
修改已有文档内容
对已有pr进行修改
操作演示
场景1 :修改已有文档内容
以修改[使用手册/节点准入]文档为例,对提pr步骤进行说明。
https://fisco-bcos-documentation.readthedocs.io/zh_CN/release-2.0/docs/manual/node_management.html
修改示例如下图所示:你发现文档中输出+++日志部分的描述,替换成输出带有"+++"的日志的描述更准确。
修订操作请看演示:
pr合入后,你会收到电子邮件通知。
场景2:对已有pr进行修改
1.打开原有pr页面;
2.点击`Files changed`进行页面跳转,再点击铅笔状图标;
3.进行修改;
4.下拉至页面结束处,如选择将本次修改内容提交到原有pr(默认第一项),可直接点击`Commit changes`按钮,修改完成;
5.如选择将本次修改内容新建pr,点击第二项后将跳转页面,参照场景1的步骤继续操作。
提交pr
感谢你能将自己的代码贡献到FISCO BCOS中,更为详细的协作方式,大家可以参考《揭秘FISCO BCOS开源项目开发协作》,这里将介绍基本的pr步骤。
适用场景
当你基于FISCO BCOS的某个版本,与开发者沟通后,已经完成基于该版本新特性的开发,或bug修复、自测。
前期准备
创建GitHub账号并登录该账号(同上述过程一致)
使用格式化工作,确保代码通过自动化检测
操作演示
FISCO BCOS pr合并流程
FISCO BCOS的项目中均配置有自己的自动化测试,你的pr提交后,请耐心等待自动化测试完成(半小时之内)。同时,你需要保证所有的单元测试时正确,合入的代码均可以在目前支持的平台上编译、执行成功,且提交的代码满足该项目的风格规范。
pr提交后,请耐心等待项目维护者进行Review。
一般来说,提交的pr会在两个工作日内进行review,项目维护者在review过程中提出一些修改建议,当修改完成后,项目维护者会将该pr标记为approve,你将会在你的GitHub邮箱中收到一封邮件。当收到两个approve后,该pr将会被合并。
一旦pr被合入,你将成为社区贡献者,登上社区贡献者荣誉榜(点击阅读原文查看榜单),并且可获得社区周边专属纪念品。欢迎大家积极参与共建FISCO BCOS。
获得帮助
加入社群
我们建有多个FISCO BCOS技术交流群,聚集各路区块链极客,欢迎你加入交流。我们纯聊技术话题,分享硬核干货,探讨基于区块链技术的商业应用场景。加入请添加社区小助手↓↓↓
FISCO BCOS的代码完全开源且免费
下载地址↓↓↓
https://github.com/FISCO-BCOS/FISCO-BCOS